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1 . SCOPE 


This specification establishes the design of a computer program 
to convert the LACIE Procedure 1 Dot Data Base Update Deck to an 
EOD-LARSYS "field definition" deck. 

The requirements specification for the program was provided by 
the Research, Test, and Evaluation (RT&E) Branch of the Earth 
Observations Division of NASA/JSC. 


i-i 

7 


2 . APPLICABLE DCXIUMENTS 


The following doc'iments form a part of this specification to the 
extent specified herein. 

• "Coding for Procedure 1 Data," provided by S. Yao/LEC 

• User Procedures EOD-LARSYS, LEC-3984 

• Task Agreement 77-2, Job Order 81-127 



3 . SYSTEM DESCRIPTION 


3.1 HARDWARE DESCRIPTION 
Not applicable. 

3.2 SOFTWARE DESCRIPTION 

The purpose of the program is to convert LACIE Procedure 1 Dot 
Data Base Update deck(s) into EOD-LARSYS compatible "field 
definition” decks. The program is coded in the IBM 360 Fortran 
IV Language for operation under the Cambridge Monitor System (CMS) 
on the IBM 360/67 at Purdue University. 

3.2.1 SOFTWARE CONPOMENT NO. 1 (DOTDEC) 

DOTDEC is an independent program. The function of DOTDEC is to 
read cards punched in the format for updating the dot data base 
file on the PDF 11/45 in JSC building 17, and to output (punch) 
"field definition” cards compatible with input requirements of 
the Univac 1108 EOD-LARSYS program. For example, the punched 
card(s) output by DOTDEC may be used for dot input to the DOT 
LABEL processor or the DOT DATA processor of EOD-LARSYS. 

3. 2. 1.1 Linkages 

DOTDEC does not require any subprograms, and is not referenced 
by any other program. 

3 . 2 . 1 V 2 Interfaces 

The program is accessed via the LARS/Purdue terminal in JSC 
building 17. The interface b'^tween the program and the user is 
the LARS/Purdue IBM 360/67 Control Program (CP) and an associated 
operating system, the Cambridge Monitor System (CMS) . 

The card reader/punch adjacent to the terminal in building 17 
will be the program's primary input/output interface. 

n 


3 . 2 . 1 . 3 Inputs 

DOTDEC requires as input the LACIE Procedure 1 Dot Data Base 
Update deck(s) in the following format with specified information 


Column 


Description 


1“4 Segment number 

5-10 Blank 

11-12 Line grid coordinate (from 01-11) 

13 Blank 

14-15 Column grid coordinate (from 01-19) 

16* Boundary pixel decision 

17* Ground truth label 

18 Blank 

19-23 Analyst information (not needed by DOTDEC) 

24 Dot type ("S” or blank) 

25-80 Additional information not utilized by DOTDEC 


Only the following columns from the input cards are used by 
DOTDEC for output of the field definition deck(s) ; 

• Columns 1-4 for the sample segment number 

• Columns 11-12 for the line (= line grid coordinate *10) 

• Columns 14-15 for the pixel (= column grid coordinate *10) 

• Column 17 for a field name to be output on the field 
definition card 

• Column 24 for dot type ("S" in column 24 represents type 1 
and anything else will represent type 2) 

*Column 17 is considered as the identification of the dot or the 
most likely identification, in the case of a boundary decision. 


Column 16 is the comparison boundary identification. 
Column 16 Column 17 


blank 

W 

"Wheat," single pixel 

0 

W 

"Wheat" with "other" boundary confusion 

B 

W 

"Wheat" with "barley" boundary confusion 

R 

A 

"Oats" with "rye" boundary confusion 

0 

B 

"Barley" with "other" boundary confusion 

0 

0 

"Other" with "other" boundary oonfursion 

blank 

F 

"flax" 

blank 

R 

"Rye" 

blank 


"blank" if unidentified 

3 , 2 . 1 . 4 Outputs 

DOTDEC outputs (punch) 

field definition deck(s) in the following 

formats ? 

CCl 


cell 

COMMENT 

SAMPLE 

SEGMENT NO. XXXX 

TYPE 

1 

* 

W 1003 

drl), 

(30,100) 

W 1701 

(1,1), 

(10,170) 

TYPE 

2 


R 1507 

(1,1) , 

(70,150) 

B 1511 

(1,1), 

(110,150) 

0 1709 

(1,1) , 

(90,170) 


Each field definition card defines the sample, line coordinates 
of a dot. The first character of the field name is the identifi- 
cation of the dot read from column 17 of the input Dot Data Base 
Update Card. The next two digits in the field name are the line 
grid coordinate taken from columns 11-12 and the last two digits 
in the field name are the column grid coordinates taken from 
columns 14-15. The line and pixel points on the output field 


definition card will be the result of line ■ line grid coordin- 
ate *10 and pixel ■ column grid coordinate *10. •’COMMENT" cards 
with the sample segment numbers separates the "field definition " 
card decks for each of the sample segments and a "TYPE" card 
will precede the "field definitions" of the set of dots within 
a given type. 

A full printer listing of the output field definition cards is 
also available. Also, the printer output will contain any error 
messages generated from the input of incorrectly formatted Dot 
Data Base update coordinates. 

3 . 2 . 1 . 5 Storage Requirements 

The program requires 43980 bytes (10995 ( 32-bit)words) of storage. 

3. 2. 1.6 Description 

DOTDEC reads up to 1000 input Dot Data Base update cards at a 
time and places the pertinent information into BUFF (1000, 6) . 

The information extracted and saved from the input cards is: 

1. Sample segment number (card columns 1-4) 

2. Line grid coordinate (card columns 11-12) 

3. Pixel grid coordinate (card columns 14-15) 

4. Boundary pixel ID (card columns 16) 

5. Ground truth label (card column 17) 

6. Dot type (card column 24) 

DOTDEC then groups the input information by seunple segment 
number. All dots within a given sample segment are ordered by 
ascending line number, and ascending pixels for a given line 
number. Following the ordering of the dots within a given 
sample segment, DOTDEC performs a grouping by dot type — Type 1 
dots or Type 2 dots - depending on the presence of an "S" or 


not an *'S" respectively/ in card column 24 of the input cards. 
After the grouping by sample segment, ordering by line and 
pixel, and sub-grouping by dot type, DOTDEC creates the punched 
card output in the following manner: 

1. Each group of dots under a given sample segment number has 
an initial card punched containing the sample segment 
number. The format of this card is in the EOD-LARSYS 
"COMMENT" card format (see section 3. 2. 1.4). 

2. Each sub-group of dots of a given type is preceded by a 
card punched in the format of an EOD-LARSYS (Procedure 1) 
"TYPE" card, containing the dot type "1" or "2" (see 
section 3. 2. 1.4} . 

3. Following the "TYPE" card, each dot of the given type has 

a card punched in the format of an EOD-LARSYS "field 
definition" card (see section 3. 2. 1.4). The dot ID in 
columns 1-6 of the card consists of the set of characters 
extracted from card column 17 (ground truth label) , 
columns 11-12 (line grid coordinate, and columns 14-15 , 

(pixel grid coordinate) . The "field definition" for the 
dot contains "(1,1)" for sample, line increment, and the 
sample, line coordinate of the dot in standard EOD-LARSYS 
"field definition" card format. 

DOTDEC continues to read input cards and punch output cards, 
in sets of up to 1000 each, until an END-OF-FILE is detected. 

DOTDEC also provides an optional printer listing of the input 
cards, the output cards, and diagnostic messages pertaining 
to any errors detected in the input cards. 

3 .2.1.7 Flow Chart 


Not applicable. 


See Appendix A. 


4 . OPERATION 


DOTDEC is executed on the LARS/PURDUE IBM 360/67 computer, using 
the remote terminal facilities in JSC building 17. Program oper- 
ation is described in terms of the terminal's operations necessary 
for execution from building 17. 

4.1 USER DOCUMENTATION 

Program DOTDEC is located on a permanent disc file which is 
referenced by an ID number and password provided by the Research, 
Test, and Evaluation Branch (RT&E) . The program can be called up 
via the Hazeltine 2000 terminal or from the 2741 typewritter 
terminal by typing in 'DOTDEC.' 

The following capabilities are provided to the user after the 
data deck is input via the card reader and DOTDEC has been 
executed on that data by typing in 'DOTDEC; 

1. A listing of the input data cards 

2. A listing of the punched output decks along with any error 
messages pertaining to the input data deck. 

3. The punched cards output by DOTDEC via the card punch, 
formatted for input to the UNIVAC 1108 EOD-LARSYS program. 

4.1.1 PROGRAM SET-UP AND EXECUTION 

The input deck (LACIE Procedure 1 Dot Data Base Update deck) 
must be preceded by a LARS /PURDUE system 'ID' card. All inputs 
■from the terminal are placed on an input buffer, so the 'ID' card 
identifies the correct inputs with the correct terminal user. 

'ID' card format is; 

CCl CCIO 

ID JSC200 (RT&E account ID at LARS/PURDUE) 



Basic order of activities for program execution are; 

1. Terminal LOGIN and acquire temporary disc file for program 
execution 

2. Transmit istput card deck to Purdue 

3 . Execute DOTDEC 

4. Initiate printing of output on line printer 

5. Initiate punching of punched output 

6. Retrieve printout and punched cards 

7. Log out on terminal 

8. Interpret the punched cards (on 026 keypunch machine) 

Notes : 

1. In the sequence of terminal commands below the user should 
note that the user typed inputs are only done after the system 
responds with a (’>') caret sign that indicates that the sys- 

^ tern is ready for the next instruction. Premature input of 
instructions without confirmation from the system that it is 
ready may produce surprising results. 

Messages shown in quotes (" ") indicate expected system 
response. 

2. The [depress CR] instructions below simply mean to depress 
the carriage return key. 

• On the Hazeltine 2000 terminal, carriage return is the 
'CR' key. 

• On the 2741 terminal, carriage return is the 'return' 
key. 


3. To erase errors: 

• On the Hazeltine 2000 terminal: 

'0' key is depressed to erase a typed'-in character, 

'[' key is depressed to erase an entire line. 

s On the 2741 terminal: 

*0* key is depressed to erase a typed-* in character, 
('cent' character) key is depressed to erase an 
entire line. 

4. If operating on Hazeltine 2000 terminal, switch terminal 
connect box ^green box adjacent to CRT screen^ to 'LARS'. 

4 . 1 . 1 . 1 Set-Up 


Terminal Activity 

[depress 'CR'] 

' RESTART ' 

> 


>L JSC200 
[depress 'CR'] 
"ENTER PASWWORD=" 

h h 1c h h It it 

[depress 'CR'J 


Description 

System will either return with 
'RESTART' and/or (>) sign. In 
either case log in with: 

'L JSC200' 

Terminal returns with 
"Enter password!* 

Type password in over mask 
characters 


"ENTER NAME=>" 
[depress 'CR'] 

"YOUR OPERATORS ARE 
"READY AT . . . ." 

"CP" 

>I CMS 

[depress 'CR'] 

"CMS READY" 


Type in initials or your name 


System returns with various 
messages 

When (>) sign returns next 
type in 'I CMS' 

System returns 

Type in - 'DISX SET S' 

4 ?^ 

V 


Terminal Activi ty 


Description 

>DISX SET S This statement asks for temporary 

(depress *CR'] disc space for your execution. 

The 'S' option asks for small disc 
which is sufficient for most pur- 
poses and is the easiest amount of 
space to obtain. If you feel you 
will need more space, you can use 
'M' in place of the 'S' which asks 
for medium space or just leave no 
option which asks for large amount 
of space. The latter request is 
the most difficult to obtain. 

After making the request for tem- 
porary diadv wait for system to come 
back with: 

"LINE END CHARACTER SET TO 

"YOU ARE LINKED TO TEMP DISK 

•'P(J ; _ FILES; _ REC IN USE, LEFT (OF ) % full ( CYL) " 

% full indicates how much of the 
disk is filled. 

If you feel there is not enough 
empty space left on the disc for 
your purposes type in: 

>LIST F Which will give a list of file 

[DEPRESS 'CR'] names and their types that are on 

that disc. Then erase as many 
files from the disc as you want by 
typing : 


Where FFPF is the file name and 
TTTT is it's type. 



>ERASE FFFF TTTT 
[DEPRESS 'CR'] 


Terminal Activity Description 

”R; T= ” After the terminal returns, continue 

the above procedure until you feel 
that there is enough storage disc 
space for your needs. 

Next read in data deck. 

4. 1.1. 2 Reading in the Input Data Deck on Card Reader 

A deck of cards can be read when there is no other activity on 

the card reader terminal, reading, printing or punching. When 

there is no activity: 

1. Remove blank cards from card READ/PUNCH hopper. 

2. Clear any cards that may still be in station by depressing 
the 'NPRD' key. 

3. Place an ID card in the front of the input deck (letters ID 
in columns 1-2 and JSC200 in columns 10-15) . 

4. Place deck in card hopper. (Cards should be 
face down with top edge of cards facing you.) 

5. Place card weight on top of deck. 

6. Turn the mode switchdial to 'TSM TRSP.' 

7. Depress 'End-of-Pile ' key. ('EOF' key) 

8. Depress 'START' key, and keep it depressed until 'READY* 
light is on. 

9. After all cards have been read, the card reader terminal 
will commence beeping. 

10. Depress 'NPRO' key again to get out any cards that may be 
still in station. 

11. Turn mode switch to 'OFF-LINE. ' 

12. Take card deck out of card bin. 


4 . 1 . 1 . 3 Processing Data Deck 

Terminal Activity Description 

Repress 'CR'] After returning to terminal wait 

a few seconds and depress *CR* 

Wai-: fot system to return following 
messages ; 

"**CARDS XPERED BY HOUSTON **'' 

"CMS" 


>0 READ DOTDEC DATA Type in '0 READ DOTDEC DATA* 

[depress 'GR'] 


"R; >= " 

> DOTDEC 

[depress 'CR'] 

"16.10.32 FILEDEF 5 DSK-Pl 
DOTDEC DATA" 


System returns 
Type in ' DOTDEC ' 
System returns 


"16.10.34 FILEDEF 6 DSK-Pl 
PRINT LISTING" 


"16.10.36 FILEDEF 7 DSK-Pl 
PUNCH OUTPUT" 


"16.10.37 LOAD DOTDEC (XEQ) 
"EXECUTION BEGINS ..." 

"R; T= " 


Execution of DOTDEC begins 
DOTDEC is completed. 


4. 1.1. 4 Printing and Punching the Output 

An offline printer copy of output is available and it is advisa- 
ble to obtain since any errors that may have occurred will only 
show up on the offline listing. 

To get an offline listing, wait until there is no other activity 
on the line printer or terminal. 


Terminal Activity 
>0 PRINT PRINT LISTING 

[depress 'crO 

”R; T» '' 

1. The LARS' terminal will commence an audible beeping; turn 
mode system knob on station to 'PRINT'. 

2. Depress 'START' key on the printer control panel. 

3. When the printing is completed, the beeping will commence 
again; turn mode system knob to "OFF LINE'. 

4. Depress 'CARRIAGE STOP' on printer control panel; then 
'CARRIAGE RESTORE' to eject paper from printer. 

5. Tear off listing. 

To obtain an off-line listing of 
the data deck follow the same proc- 
edure as above except type: 

>0 PRINT DOTDEC DATA 0 PRINT DOTDEC DATA 

[depress 'CR'] 

instead of >0 PRINT PRINT LISTING. 

To obtain punched card output, again 
wait until the terminal is free of 
activity, then type: 

>0 PUNCH PUNCH OUTPUT 'o PUNCH PUNCH OUTPUT' 

[depress 'CR'] 

1. Go over to terminal and place stack of blank cards into hopper 

face down with top edge of cards facing you . 

2. Turn mode system knob to "PUNCH". 

3. If beeping sound has not come on yet, wait until you hear it. 

4. Depress 'START' button and keep it depressed until 'READY' 
light is on. 

/■i 



Type in *0 PRINT PRINT LISTING' 
System returns 


5. Punching is completed when beeping sound comes on again. 

6. Remove extra blank cai.ds from hopper. 

7. Depre*;^ 'NPRO' button to get out any excess cards that might 
still be in system. 

8. Turn mode system knob to ’OFF-Line’ 

9 . Take punched cards put of bin . 

4. 1.1. 5 Sign off LARS' system by typing in: 

>CP LOGOUT 
[DEPRESS 'CR'3 

* • I 

An example can be found on the following page. 


Example 


L JSCEOO 

EN TERP ftSSWDRD * 

ENTER. NflHE:>6DR 

YOUR DPERfiTORS THIS RFTERNODN RPE DERNIE RNB DOUG. 

EXT POSSIBLE SHUTDOWN IS 0100-0800 WED. 

RERDY HT 14.35.4E ON 06/EI/77 
CP 

>I CMS 

CMS <VER 3.£> RERDY? 

>DISX SET S 

LINE END CHRRRCTER SET TO \ 

YOU RRE LINKED TO TEMP DISK 21 

P <18£>: 6 FILES? 176 REC IN USE» 120 LEFT <OF £96 59^. FULL <2 CYL 
? T*2.01/3.06 14.36.30 

> 

♦♦ CRRDS XFERED BY HOUSTON ♦♦ 

CMS 

>0 RERD DOTDEC DRTR 
R5 T=0.a3/0.11 14.46.40 

>DDTDEC 

14.46.45 FILEDEF 5 DSK-Fl DOTDEC DRTR 
14.46.4? FILEDEF 6 DSK-Pl PRINT LISTING 
14.46.43 FILEDEF 7 DSK-Pl PUNCH DUTPl'T 
14.46.50 LORD DOTDEC CXEO.^ 

EXECUTION BEGINS... 
r; T= 0.64^' 0.93 14.46.54 

>0 PRINT PRINT LISTING 
R5 T»0.1£/0.31 14.48.26 

>0 PUNCH PUNCH OUTPUT 
Rj T*0.06.'0.16 14.50.16 

>CP LOGOUT 

CDNNECT= 00:16:01 VIRTCPU= 000:02.88 TDTCPU= 000:05.03 
DGOUT RT 14.51.39 ON 06.-'£l/7? 

W'-G? ONLINE 





5 . TEST prcx:edure 


5.1 DESCRIPTION OP TEST 

The test run on this program was done with the data listed on the 
following page. Data consisted of two invalid coordinates to 
test error checking. Six different sample segments 
were input at random. Also the coordinates were not input in 

I 

ascending line number and ascending pixel per line# to test the 
program's ordering technique. 

The printer listing of the punch output shows data grouped 
according to sample segments and type . and then ordered in 
ascending line number and ascending pixel in each line. 
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TEST VERIFICATION 


For: Dot Data Base Update Deck Conversion 


This verification Is being conducted to Insure that the delivered 
program products satisfy the requirements as originally stated by 
the requesting organization. 

" • 

NASA Monitor J 

- - 

Requestor 



Quality Assurance 



Test Conductor 


Verification Date; 
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